home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 1995 #1 / Amiga Plus 1995 #1.iso / fish-disketten / fish_851-860 / d860 / azmake / azmakedok.ger < prev    next >
Text File  |  1994-12-13  |  10KB  |  233 lines
  1. ============================================================================
  2.  
  3.           AAAAAAA   ZZZZZZZ   M     M   AAAAAAA   K    K  EEEEEEE
  4.           A     A        Z    MM   MM   A     A   K   K   E
  5.           A     A       Z     M M M M   A     A   K  K    E
  6.           AAAAAAA    ZZZZZ    M  M  M   AAAAAAA   KKK     EEEE
  7.           A     A     Z       M     M   A     A   K  K    E
  8.           A     A    Z        M     M   A     A   K   K   E
  9.           A     A   ZZZZZZZ   M     M   A     A   K    K  EEEEEEE
  10.  
  11. ============================================================================
  12.  
  13. AzMake 2.3
  14. Eine "Arbeitsumgebung für Aztec C"
  15.  
  16. Dieses Programm ist SHAREWARE! Es darf frei weitergegeben werden, solange
  17. dieses Textfile und das Programm unverändert zusammen bleiben, allerdings
  18. nur auf privater Basis. Dieses Programm darf ohne meine schriftliche
  19. Einwilligung nicht in andere Serien als "Amiga Lib Disk" von Fred Fish,
  20. "Franz" von Holger Franz und die "Amiga Szene" von SEP übernommen werden.
  21. Auch darf das Programm nicht alleine verkauft werden, ebenso ist ein Vertrieb
  22. zusammen mit komerzieller Software verboten.
  23. Es handelt sich hierbei um eine vollständig lauffähige Version, mit der
  24. Einschränkung, daß in unregelmäßigen Abständen eine Aufforderung erscheint,
  25. doch bitte die Shareware Gebühr zu zahlen. Ich habe in dieses Programm viel
  26. Zeit investiert, und möchte dafür eine Gebühr von DM 20 oder US$ 15 vorschlagen.
  27. Wer diese Gebühr bezahlt, bekommt eine Version ohne "Zahlungsaufforderung",
  28. sowie den vollständigen Sourcecode in Aztec C.
  29. Für irgendwelche Beschädigungen, die durch den Gebrauch von AzMake entstehen,
  30. kann ich keine Haftung übernehmen.
  31.  
  32. Installation:
  33. AzMake wird über die Shell oder die Workbench aufgerufen.
  34. Die intuition.library und die graphics.library, sowie
  35. Treiber für den Drucker (prt:) werden benötigt. AzMake läuft unter Kick
  36. 2.0 und größer (??), mit und ohne Turbokarte, etc. (ich konnte keine
  37. Einschränkungen feststellen).
  38. Desweiteren muß natürlich Aztec C installiert sein. (Ich arbeite mit 5.2,
  39. aber AzMake müßte auch mit älteren Versionen zusammenarbeiten.) Die
  40. Installation von Aztec C (set der EnvVars etc.) ist wie im Handbuch be-
  41. schrieben durchzuführen, eine Neuinstallation ist also nicht notwendig.
  42. Allerdings müssen sich "cc, as, ln" in einem mit PATH definiertem Pfad
  43. befinden.(Beim Start von der WB im Verzeichnis c:)
  44. AzMake läuft unter der Priorität -1, dürfte also cc, as, ln nicht
  45. beeinflussen.
  46. Von AzMake aus kann man Programme compilieren, assemblieren, linken,
  47. drucken, etc..
  48. Da ich nie ein Freund von MakeFiles war, ist dieses Programm entstanden.
  49.  
  50.  
  51.  
  52. Die Gadgets:
  53. ------------
  54.  
  55. Mini:
  56.     Das Fenster wird auf minimale Größe verkleinert, und in die linke,
  57.     obere Ecke des Workbenchscreens gelegt. Das Outputfenster wird ganz
  58.     geschlossen. Das "Mini-Fenster" kann auch an eine beliebige Stelle
  59.     der WB gezogen werden, und beim nächsten Mal erscheint es dort wieder.
  60.     Um wieder auf die normale Größe zu gelangen, muß das Minifenster
  61.     aktiv sein, dann die rechte Maustaste drücken.
  62.     Wird das Fenster auf Mini Größe verkleinert, so wird die aktelle Höhe,
  63.     NICHT Breite des Ausgabefensters gespeichert, und beim erneuten Öffnen
  64.     wieder hergestellt. (Breite IMMER 640)
  65.  
  66. Info:
  67.     Es erscheint ein Copyright Info.
  68.  
  69. Cc:
  70.     Es wird der Compiler aufgerufen.
  71.     Die gadgets sind für die Zeit des Compilierens nicht anwählbar.
  72.     (Ebenso bei as und ln)
  73.     Die Optionen werden wie folgt eingebunden:
  74.     " cc <Mainfile> <Compiler Opt> "
  75.  
  76. As:
  77.     Es wird der Assembler aufgerufen. Dies macht natürlich nur Sinn, wenn
  78.     der Compiler mit "-a" als Option aufgerufen wurde.
  79.     " as <MainFile>.asm <Assembler Opt> "
  80.  
  81. Ln:
  82.     Aufruf des Linkers. Die Optionen im "Linker Opt" Gadget werden ein-
  83.     gebunden. (-lc ist default)
  84.     " ln <MainFile>.o <Linker Opt> "
  85.  
  86. Cc & Ln:
  87.     Wenn man sich sicher ist, daß beim Compilieren kein Fehler gemeldet
  88.     wird, kann man dieses wählen, es werden Cc und Ln nacheinander aus-
  89.     geführt. Für Informationen siehe dort. Wenn in den Compiler Optionen
  90.     -a steht, macht dieses natürlich keinen Sinn.
  91.  
  92. Dir:
  93.     Gibt das aktuelle Direktory aus. Der Name wird dabei als erstes ausgegeben,
  94.  
  95. Pick File:
  96.     Es erscheint ein FileRequester, um das gewünschte Sourcefile zu
  97.     bestimmen. Es werden nur Files mit der Endung ".c", ".h" oder ".asm"
  98.     akzeptiert. Dabei werden, falls vorhanden, die Optionen für Compiler,
  99.     Assembler und Linker auch geladen.
  100.  
  101. Save Options:
  102.     Die Optionen, welche sich in den CcOpt-, AsOpt-, LnOpt- Gadgets
  103.     befinden, werden unter dem Namen des Mainfiles mit der Endung
  104.     ".azcfg" gespeichert, so daß sie beim erneuten laden dieses Programmes
  105.     nicht neu eingegeben werden müssen. Dies ist sinnvoll bei vielen
  106.     Optionen, und wenn man zwischen mehreren Files wechselt.
  107.  
  108. NewShell:
  109.     Öffnet eine neue Shell, um Dosbefehle auszuführen, oder aber um die
  110.     unten beschriebenen Probleme zu umgehen, und so ein Programm zu testen.
  111.  
  112. Run Program:
  113.     Das Programm, welches im MainFile Gadget steht, wird ausgeführt. Dies
  114.     dient zum schnellen testen, aber VORSICHT: Es werden die gleichen Ein-
  115.     - und Ausgabekanäle benutzt wie bei AzMake. Ein einlesen vom CLI ist
  116.     nicht möglich, also nur eine eingeschränkte Alternative gegenüber dem
  117.     Aufruf über die Shell.
  118.  
  119. Print Source:
  120.     Das Programm, welches in MainFile steht wird über PRT: ausgedruckt.
  121.     Die in den Prefs stehenden Einstellungen werden also übernommen.
  122.  
  123. Kill Window:
  124.     Wenn man programmiert, und ein Programm stürzt ab (TASK HELD), oder
  125.     schließt ein Fenster nicht ordungsgemäß, so ist ein weiterarbeiten
  126.     zwar kein Problem, das (oder die) offene Fenster kann aber sehr wohl
  127.     hinderlich sein. Wenn man "Kill Window" wählt, werden alle zur Zeit
  128.     auf der Workbench geöffneten Fenster mit Namen und Position ausgegeben.
  129.     VORSICHT: AzMake überprüft nicht, ob es zu dem zu schließenden Fenster
  130.     noch einen Task gibt, sondern schließt es ohne jegliche Rückfrage. Sobald
  131.     also ein Fenster ausgewählt ist, und "OK" angeklickt wird, so wird dieses
  132.     Fenster geschlossen. Bei einer unsachgemäßen Benutzung kann ein GURU also
  133.     nicht ausgeschlossen werden.
  134.  
  135. MainFile:
  136.     Hier steht der Name des Programmes, ohne Endung. Um ein Programm zu
  137.     selektieren bitte >> Pick File << anklicken.
  138.  
  139. Compiler Opt:
  140.     Hier werden die Optionen für den Compiler eingetragen. Sie werden
  141.     von AzMake nicht auf Gültigkeit überprüft, sondern 1:1 weitergegeben.
  142.  
  143. Assembler Opt:
  144.     Assembler Optionen......
  145.  
  146. Linker Opt:
  147.     Linker Optionen. Voreingestellt ist die "Minimaloption" -lc.
  148.  
  149.  
  150. Die Gadgets können (bei aktivem AzMake Fenster) durch die unterstrichenen
  151. Buchstaben über die Tastatur ausgelöst werden. (z.B. Taste m für Mini) Groß-
  152. und Kleinschreibung wird nicht unterschieden.
  153.  
  154.  
  155. Die Menus:
  156. ----------
  157. Mini:
  158.     Hat die gleiche Funktion, wie die Wahl des Mini Gadgets.
  159.  
  160. About:
  161.     Ein Simple Request mit meinem Copyright Info erscheint.
  162.  
  163. Quit:
  164.     Beendet das Programm (gleiche Funktion, wie Fenster mit CloseGadget schließen)
  165.  
  166. Save Startup:
  167.     Die Inhalte der Optionen Gadgets, sowie der aktuelle Filename und das aktuelle
  168.     Direktory werden in ein File "s:AzMake.cfg" gespeichert. Dies hat den Vorteil,
  169.     daß wenn AzMake erneut aufgerufen wird die kompletten Pfade und Optionen
  170.     geladen werden, so daß man direkt (ohne erneut erst mit Pick File den Quelltext
  171.     zu laden) mit den alten Einstellungen weiterarbeiten kann, was bei teilweise
  172.     tiefen Verschachtelungen auf der Festplatte Zeit spart.
  173.     Findet AzMake kein File AzMake.cfg im s: Verzeichnis, so wird auch nichts
  174.     geladen.
  175.  
  176. Load Startup:
  177.     Hat man bei der Arbeit einen anderen Quelltext gewählt um z.B. etwas
  178.     auszuprobieren, so läd AzMake die unter s:AzMake.cfg Optionen und Pfade wieder
  179.     ein.
  180.  
  181. Delete Startup:
  182.     Löscht das File s:AzMake.cfg, falls dort z.B. ein ungültiger Pfad steht, weil
  183.     die Platte neu organisiert wurde, etc.
  184.  
  185. Delete ().o File:
  186.     Löscht nach dem Linken automatisch das Objektfile des Programmes, aber ACHTUNG:
  187.     AzMake erkennt nicht, ob der Linkvorgang erfolgreich war, und löscht auf jeden
  188.     Fall, so daß bei falscher Linklibrary und durchaus korrektem Objektfile eine
  189.     erneute Compilation nötig wird.
  190.  
  191.  
  192. Alle Menus, die eine Shortcutangabe hinter der Bezeichnung stehen haben, können
  193. natürlich auch über Shortcuts aufgerufen werden.
  194.  
  195.  
  196. ----------------                 ARexx              ------------------------
  197.  
  198. AzMake verfügt über einen ARexx Port mit Namen >> REXX_AZMAKE <<.
  199. Es kann so Nachrichten von ARexx erhalten und verarbeiten.
  200. Es MUß ARexx vor AzMake aufgerufen werden, da sonst der Port nicht geöffnet werden
  201. kann. Falls AzMake schon läuft, und noch einmal aufgerufen wird, kann der ARexx
  202. Port natürlich nicht ein zweites Mal geöffnet werden, und das neu aufgerufene
  203. AzMake bricht mit einem Hinweis darauf ab.
  204. AzMake versteht unter ARexx die Befehle "cc", "as", "ln" und "ccln". Groß- und
  205. Kleinschreibung wird nicht unterschieden.
  206. Diese werden dann ausgeführt, als wenn das entsprechende Gadget gewählt wurde.
  207. Sinnvoll ist es AzMake nach Eingabe der richtigen Optionen mit Mini zu verkleinern,
  208. und dann, z.B. direkt von einem ARexx-fähigen Editor aus, ferzusteuern. AzMake öffnet
  209. so nur sein Ausgabefenster, welches nach dem compilen, linken etc, einfach
  210. durch das Closegadget geschlossen wird.
  211.  
  212. Ein AzMake Aufruf zum Compilieren unter ARexx von der Shell könnte so aussehen:
  213. 1.DH0:>rx "address REXX_AZMAKE cc" (return)
  214. Ein Makro (z.B. im Editor) :
  215. "address REXX_AZMAKE cc"
  216.  
  217.  
  218.  
  219. ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
  220.  
  221. Ich möchte noch einmal darauf hinweisen, daß es sich um Shareware handelt,
  222. also alle Rechte bei mir liegen.
  223. Nach Zusendung der Gebühr (Schein oder Scheck) bekommt man eine
  224. Diskette mit einer lauffähigen Version, sowie die kompletten C Sourcecodes.
  225.  
  226. Christian Friedel
  227. Jägerstraße 6
  228. W 5064 Rösrath 3 (Ab Juli [Neue Postleitzahlen] 51503 Rösrath)
  229. Germany
  230.  
  231.  
  232. ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
  233.